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Section 1 
Introduction 



1. 1 GENERAL INFORMATION 

Be sure to copy and/or write protect the installation media. 
For copy procedures/ refer to the DN05 Operations Guide / part 
number 2270502-9701. Also, consult the T I FORM Release 
Information / part number 2276479-9901 before beginning this 
instal lation. 

Some System Command Interpreter (SCI) commands in this document 
are presented in batch format. You can execute them by 
entering the commands exactly as shown or by using interactive 
prompting from SCI. For a discussion of the batch command 
format/ refer to the DNOS Sustem Command Interpreter (SCI ) 
Reference Manual. 



1.2 MEDIA DEFINITION 

Product shipments are made in four formats: 

* Hard Disk — A disk pack that contains the object. 

* Diskettes — Three double-sided/ double density (DSDD) 
diskettes that contain the object: 

TIFRMNF1 Contains the TIFORM object directories. 

TIFRMNF2 Contains any patches needed to make TIFORM 
perform correctly. 

TIFRMNF3 Contains four directories that are not 
installed: DEMOINS/ LINKD/ PASCAL, and 
TESTFORM. These are used for developing and 
testing TIFORM applications as explained in 
the Release Information. (On other media, 
these directories are on the same volume as 
the object. ) 



* Magnetic Tape - A magnetic tape that contains the 
ob ject. 
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* Add -On - A disk pack that contains the TIFORM object 
along with one or more other products. 

The installation instructions in this document assume that the 
object files are accessible by a synonym. Section 2 describes 
how to prepare the media so that the files can be accessed by a 
synonym. 



1.3 INSTALLATION PROCEDURE 

Before you can install TIFORM you must prepare the media and 
assign the synonym TIFRMINS to the volume or directory that 
contains the object directories and installation batch streams. 
The installation itself involves the following steps: 



1. Install the TIFORM object by 
command. 



executing the ITIFORM 



Patch the TIFORM 
command. 



object by executing the PTIFORM 



Verify the installation by testing the FDL Compiler, 
Form Executor, and Interactive Screen 
Gen era tor /Ed i tor. 



1.4 SYSTEM REQUIREMENTS 

To successfully perform this installation procedure, you must 

have a functioning DNOS system, version 1.2.0 or later. Your 
DNOS system must contain key indexed file (KIF) support in 

order to build the TIFORM message file. TIFORM installs this 

message file on your DNOS system disk under the directory 
. SfMSO. 
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Section 2 
Preparing for Installation 



2. 1 INTRODUCTION 

Before you install the TIFORM object, you must install the 
object media and assign the synonym TIFRMINS to the volume or 
directory that contains the object. The following paragraphs 
describe how to prepare each type of media. 



2. 2 DISK FORMAT 

The name of the TIFORM object disk is TIFRMNH. It contains all 
the object modules needed to run TIFORM/ a file of TIFORM 
patches, and some additional directories used for developing 
and testing TIFORM applications. To prepare for the 
installation/ perform the following steps: 

1. Load the disk in an available drive on a functioning 
DNOS system, version 1. 2. O or later. 

2. Install the disk by executing the following command: 

IV UNIT=DSxx, VOLUME=TIFRMNH 

where: 

DSxx is the device name of the drive where the disk 
has been loaded. 

3. Enter the following command to assign the synonym 
TIFRMINS to the object installation disk: 

AS SYN=TIFRMINS, VALUE=TIFRMNH 

Now proceed to Section 3 for instructions for installing the 
object. 
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2. 3 DISKETTE FORMAT 

The names of the TIFORM object diskettes are TIFRMNF1, 
TIFRMNF2, and TIFRMNF3. TIFRMNF1 contains all the object 
modules needed to run TIFORM. TIFRMNF2 contains the file of 
TIFORM patches. TIFRMNF3 contains some additional directories 
used for developing and testing TIFORM applications. To 
prepare for the instal lation, perform the following steps: 

1. Load the diskette labeled TIFRMNF1 in an available 
drive on a functioning DNOS system, version 1.2.0 or 
later. 

2. Install the disk by executing the following command: 

IV UNIT=DSxx, V0LUME=TIFRMNF1 

where: 

DSxx is the device name of the drive where the 
diskette has been loaded. 

3. Enter the following command to assign the synonym 
TIFRMINS to the object installation diskette: 

AS SYN=TIFRMINS, VALUE=TIFRMNF1 

Now proceed to Section 3 for instructions for installing the 
ob jec t. 
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2. 4 MAGNETIC TAPE FORMAT 

When your receive the TIFORM object on a magnetic tape reel or 
cartridge, you must first move the object files and directories 
to a disk before you begin the installation process. To 
prepare for the installation! perform the following steps: 

i. Enter the following command to assign the synonym 
TIFRMINS to the pathname of a scratch directory: 

AS SYN=TIFRMINS. VALUE=<vo 1 ume>. TAPECOPY 

In this command. <volume> must be the volume name of 
the disk that is to contain the scratch directory. 

2. Enter the following command to create a scratch 
directory for the installation: 

CFDIR PATHNAME=TIFRMINS, M=50 

3. Load the magnetic tape reel or cartridge in an 
available drive on a functioning DNOS system, version 
1. 2 or later. 

4. Enter the following command to move the contents of 
the magnetic tape reel or cartridge to the scratch 
directory you created: 

RD SEQ=MTxx, DIR=TIFRMINS, LIST=<pathname> 

where: 

MTxx is the name of the tape drive containing 
the TIFORM release tape. 

<pathname> is the pathname for the listing of the 
directory restored from the magnetic 
tape. You can examine this file by 
executing a Show File (SF) or Print File 
(PF> command. 

5. Unload the magnetic tape. 

Now proceed to Section 3 for instructions for installing the 
ob jec t. 
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2. 5 ADD-ON FORMAT 

In an add-on package, the TIFORM object is in the directory 
TIFRMMH on the installation disk. The other directories on the 
disk contain other products. To prepare for installation, 
perform the following steps: 

1. Load the add-on disk in an available drive on a 
functioning DNOS system* version 1.2.0 or later. 

2. Install the disk using the following command: 

IV UNIT=DSxx, VOLUME=<volume> 

where: 

DSxx is the drive where the add-on disk is 
loaded. 

<volume> is the volume name of the add-on disk. You 
can find the volume name marked on the disk 
or you can execute a Show Volume Status 
(SVS) command to obtain the volume name. 

3. Enter the following command to assign the synonym 
TIFRMINS to the directory that contains the TIFORM 
ob ject: 

AS SYN=TIFRMINS, VALUE=<vo 1 ume>. TIFRMNH 

Now proceed to Section 3 for instructions for installing the 
ob ject. 
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Section 3 
Installing the Object 



This section describes the procedure for installing the TIFORM 
object on a DNOS system. The installation process deletes any 
previously installed version of TIFORM and installs the new 
TIFORM components on the system disk. To install the TIFORM 
objecti perform the following steps: 

1. Firsti enter the following SCI command to gain access 
to the TIFORM installation menu and command library: 

. USE TIFRMINS, . S*CMDS 

2. Assign the synonym DSC to the volume name of the ONOS 
system disk: 

AS SYN=DSC» VALUE=<volume> 

where: 

<volume> is the volume name of the system disk where 
you want to install TIFORM. 

3. Enter the Install TIFORM (ITIFORM) command and 
respond to its prompts as described below: 

C 1 ITIFORM 

INSTALL TIFORM 
TARGET SYSTEM VOLUME NAME: <volume> 

LISTING ACCESS NAME: <pathname> 

where: 

■Cvolume> is the volume name of the system disk 
where you want to install TIFORM. The 
initial value of this prompt is the 
pathname that you assigned to the synonym 
DSC. 

<pathname> is the pathname of the file where you want 
to receive the listings for the 
installation process. 
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If ITIFQRM detects no errors* the following message 
appears: 

TIFORM OBJECT INSTALLATION IN PROGRESS 

This process takes about eight to twenty minutes to 
execute. During this time you can check the progress 
of the installation by entering the Show Background 
Status (SBS) or Wait (WAIT) command. 

4. When the execution has completed* you receive the 
following message: 

n ERRORS INSTALLING TIFORM 

If the error count is not zero* the listing file 
indicates the cause of the error. If the 
installation is error-free* the listing file contains 
a disk map of the . S*TIFORM directory showing the 
files installed. The installation process also 
installs the following tasks on the program file 
. S*TIFORM. S*PROG: EXECT911, FDLC, ISGE, FDLBUILD, 
and EXECT820. ITIFORM also assigns the global 
logical name SfTIFORM to the directory . S*TIFORM. 

Now proceed to Section 4 for instructions for patching the 
installed object. 
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Section 4 
Patching the Object 



4. 1 INTRODUCTION 

Before you can use TIFORM, you must apply patches to the 
object. To apply the patches* follow the instructions in this 
section. 



4. 2 PATCHING AFTER INSTALLATION 

When you install TIFORM from disk, tape# or add-on, your 
patches are included with the TIFORM object. When you install 
from diskettes, you must perform these steps to unload the 
object diskette and load the diskette that contains the 
patches. 

1. Enter the following command to release the TIFORM 
installation command library: 

. USE 

2. Enter the following command to unload the object 
d iskette: 

UV vTJLUME=TIFRMNFl 

3. Unload TIFRMNF1 and load TIFRMNF2. Then, enter the 
following command to install TIFRMNF2: 

IV UNIT=DSxx, V0LUME=TIFRMNF2 

where: 

DSxx is the drive where TIFRMNF2 is loaded. 

4. Enter the following command to assign the synonym 
TIFRMINS to TIFRMNF2: 

AS SYNONYM=TIFRMINS, VALUE=TIFRMNF2 

5. Enter the following command to access the TIFORM 
installation command library on TIFRMNF2: 

. USE TIFRMINS, . S*CMDS 
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To apply the TIFORM patches, enter the Patch TIFORM (PTIFORM) 
command from the TIFORM installation menu. Respond to the 
prompts as described. 

C 3PTIFORM 



PATCH TIFORM 

TARGET SYSTEM VOLUME NAME 

TIFORM PATCH FILE PATHNAME 

HISTORY COMMAND DIRECTORY 

TIFORM COMMAND DIRECTORY 

LISTING ACCESS NAME 



<volume> 
•Cpatchf i le> 
<h i story > 
<commands> 
<listf ile> 



where: 



Ivolume> is the volume name of the disk inhere TIFORM is 
instal led. 



<patchfile> is TIFRMINS. PT. MTASK, the pathname of the 
TIFORM patchfile located on the object 
installation disk. If you receive a patch 
update and copy the patch file to a new 
location, use the pathname of the new copy. 

<history> is the pathname of the history command 
directory, usually . SfSYSTEM. S**CMDS. 

<commands> is the command library where the TIFORM 
commands (such as XFDLC ) are installed. 
Usually this is . S*CMDS. 

<listfile> is the pathname of a file to receive listings 
from the patch process. 



If PTIFORM detects no errors, the following message appears: 

TIFORM PATCHING IN PROGRESS 

After the patch procedure has completed, you receive the 
following message: 

n ERRORS ON TIFORM MULTI-TASK PATCH STREAM 

If patch error count is not zero, examine the listing file to 
find and correct the error. If the completion message reports 
no errors, then the patches have been applied successfully and 
you can proceed to Section 5 to verify the installation. 
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4. 3 APPLYING PATCHES AT A LATER DATE 

In addition to any patches you receive with the TIFORM object, 
you can also use the PTIFORM command to apply any TIFORM 
patches you receive at a later date. To do so, you need access 
to the PTIFORM command, which is currently in TIFRMINS. PTIFORM. 
Paragraph 5. 5 provides instructions for copying PTIFORM and 
other components of TIFORM included with the object. 
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Section 5 
Verifying the Installation 



5. 1 INTRODUCTION 

Before you begin using TIFORM, you must run three tests to 
verify the success of a TIFORM installation. If you have just 
completed the object installation/ enter the following command 
to return to your usual SCI main menu: 

. USE <libraries> 

inhere: 

<libraries> is your list of SCI command libraries. One 
of these must be the library that contains 
the TIFORM commands — usually . S*CMD5. 

The object media contains everything you need to run the tests. 
When you install TIFORM from disk, tape* or add-on, your test 
materials are included with the TIFORM object. When you 
install from diskettes, you must perform these steps to unload 
the patch diskette and load the diskette that contains the test 
materials. 

1. Enter the following command to unload the object 
d iskette: 

UV V0LUME=TIFRMNF2 

2. Unload TIFRMNF2 and load TIFRMNF3. Then, enter the 
following command to install TIFRMNF3: 

IV UNIT=DSxx, V0LUME=TIFRMNF3 

where: 

DSxx is the drive where TIFRMNF3 is loaded. 

3. Enter the following command to assign the synonym 
TIFRMINS to TIFRMNF3: 

AS SYNONYM=TIFRMINS, VALUE=TIFRMNF3 
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5.2 TEST 1: FDL COMPILER VERIFICATION 

Enter the following command to compile the test program and 
test the FDL compiler: 

XFDLC SOURCE=TIFRMINS. TESTFORM. TEST2, 
OBJECT=S*TIFORM. PROG, 
LIST- LISTING 

This command executes for approximately one minute on a quiet 
system. Enter the Wait (WAIT) command to wait for completion. 

At the end of a successful compilation, you receive the 
following message: 

FDL ERROR COUNTS: OOO 000 000 000/000 000 000 000 000 : 

If this message does not appear* or any of the error counts is 
nonzero, refer to Appendix C of the T I FORM Reference Manual for 
an explanation and corrective action. 



5.3 TEST 2: FORM EXECUTOR VERIFICATION 

Enter the following command to execute the test program and 
test the Form Executor: 

C 3 FORMTSTR 

When the Form Tester menu appears, perform the following tests: 

1. Enter 01 and press the Return key to open a form. 
Specify a program file of S*TIF0RM. PROG, a form name 
of FLAB01, and a terminal of ME. Press the Return 
key in response to the SURE? prompt. When the 
cursor reappears, press the Return key again. 

2. Enter 20 and press Return to display the status of 
the Form Tester session. The FORM STATUS field and 
the OS STATUS field should be 00. Press the Return 
key to respond. 

3. Enter 02 and press Return to prepare a segment. 
Specify a segment name of SLAB01 and a group name of 
SLAB01. Press the Return key in response to the 
SURE? prompt. The following image appears on the 
screen. 
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USED BODY PARTS 



DATE: 
SOLD TO 



INVOICE # 
TERMS: 



PART # QTY DESCRIPTION PRICE 

########################################################### 
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# 
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# 
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# 



########################################################### 

SUBTOTAL # # 

########## 

TAX # # 

########## 

TOTAL AMT # # 

########## 



The box is displayed in graphic characters 
cursor is positioned in the INVOICE # field. 



and the 



4. Press the Print key. 
is printed on the 
confirmation message 
screen. Press the 



A printout of the figure above 

device assigned to TIFORM and a 

appears at the bottom of the 

Return key to acknowledge the 



message and return the cursor to the INVOICE # field. 

5. Press the Previous Field key. Then* press the Return 
key to return to the Form Tester main menu. 

6. Enter 20 and press the Return key to display the new 
status of the Form Tester session. The FORM STATUS 
field is 01, the TEXT LENGTH is 200, and the GROUP 
LENGTH is 408. All other fields have a value of 0. 
Press Return to go back to the Form Tester main menu. 



7. 



Enter 22 and press Return. Respond Y 
prompt to exit the FORMTSTR. 



to the SURE? 



This completes the verification of the Form Executor using the 
Form Tester. If any of the STATUS fields contain values other 
than those specified in the preceding, refer to Appendix C of 
the TIFORM Reference Manual for an explanation of the error. 
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5.4 TEST 3: ISGE VERIFICATION 



To verify the installation of TIFORM's Interactive Screen 
Generator/Editor/ you need to initialize a new segment and 
create the FDL from that segment. Refer to the ISGE tutorial 
in Section 4 of the T I FORM Reference Manual. 



5. 5 CONCLUDING THE INSTALLATION PROCESS 

Once you have verified that the installed TIFORM performs 
correctly, you are ready to conclude the installation process. 
Before you unload the object media or delete the installation 
directory* you might wish to copy certain components of TIFORM 
that are included with the object media. If you decide not to 
save them, you can still access them later after preparing the 
object media for installation as described in Section 2. To 
conclude the installation process* perform the following steps: 

1. Enter the appropriate commands from the following 
list to save the TIFORM components you wish to keep 
for later use: 

For removing TIFORM from the system: 

CC I=TIFRMINS. REMOVE, 0=<pathname>. REMOVE 

For patching TIFORM at a later date: 

CC I=TIFRMINS. PTIFORM, 0=<pathname>. PTIFORM 

For creating a linkable version of TIFORM: 
CD I=TIFRMINS. LINKD, 0=<pathname>. LINKD 

where : 

<pathname> is a directory to hold the TIFORM 
parts. 

2. If you have installed from tape, enter the following 
command to delete the scratch directory: 

DD PATHNAME=TIFRMINS, ARE YOU SURE?=YES 

Otherwisei enter the following command to unload the 
installation disk: 

UV VOLUME=TIFRMINS 



3. Remove the installation disk, diskette, or tape from 
its drive. 
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4. Enter the following commands to delete the remaining 
synonyms used in the installation process: 

AS SYNONYM=TIFRMINS, VALUE="" 
AS SYNONYM=DSC* VALUE="" 

This completes the installation of TIFORM. 



2272096-9701 5-5/5-6 



Removing TIFORM 



Section 6 
Removing TIFORM 



If you wish to delete the installed TIFORM from your system* 
use the following procedure: 

1. Assign the synonym DSC to the disk where TIFORM is 
installed using the following command: 

AS SYNONYM=DSC, VALUE=<vo 1 ume> 

where: 

<volume> is the disk where TIFORM is installed. 

2. Execute the batch stream named REMOVE/ which is 
supplied on the installation media, by executing the 
following command: 

XB INPUT=<directory>. REMOVE, LISTING=<pathname> 

where: 

<directory> is the directory that contains the 
REMOVE batch stream. 

<pathname> is the pathname of the listing file 
for the operation. 
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